home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / gigo0714.zip / MAILLIST.CFG < prev    next >
Text File  |  1996-07-14  |  12KB  |  245 lines
  1.  
  2. ; MAILING LISTS!
  3. ; GIGO will now internally support hosting of mailing lists.
  4. ; If you are not hosting the mailing list, but instead trying
  5. ; to _gate_ the mailing list, see the MAPPING.CFG file instead.
  6. ;
  7. ; Once again:  This section is if you want to HOST a mailing list.
  8. ;
  9.  
  10.  
  11. ;  ┌──────────────────────────────────────────────────────────────┐
  12. ;  │ IF YOU WISH TO USE THE MAILING LIST FEATURES, YOU WILL       │
  13. ;  │ NEED TO MAKE SURE THAT THIS CONFIG FILE GETS INCLUDED IN YOUR│
  14. ;  │ SETUP!                                                       │
  15. ;  │ IE, ADD   "Include MailList.Cfg"  TO YOUR GATEWAY.CFG FILE!  │
  16. ;  └──────────────────────────────────────────────────────────────┘
  17. ;
  18. ; There are two keywords involved.  CAPTURE is what will capture
  19. ; the messages from a given email address, echomail area, or newsgroup,
  20. ; and save them as .MLQ files in the directory you specify.
  21. ; EXPLODE will take the MLQ files, and send them out to a list of recipients.
  22. ;
  23. ; In addition, you will need to setup SITE statements for the purpose of 
  24. ; giving the mailing list (which is email based) access to posting 
  25. ; into the newsgroups and into the echos with.
  26. ;  
  27.  
  28. SITE  pnews  news ; Any mail sent to  news.group@pnews.yoursite.domain gets posted
  29. SITE  pecho  echo ; Any mail sent to  echoname@pecho.yoursite.domain gets posted
  30.  
  31.  
  32. ; When GIGO is sending out messages for your mailing list, it tries to bunch
  33. ; as many people as possible onto each message, thereby reducing how much outgoing
  34. ; traffic you actually create.  By default, it is about 10 addresses per outgoing
  35. ; message, meaning that a mailing list with 50 recipients will generate about
  36. ; 5 outgoing messages (instead of 50!).
  37. ;
  38. ; Of couse, this parameter is tweekable :-)
  39. ;
  40. ; The MAXRMAIL command specifies the maximum line length for outgoing
  41. ; email to your host.  If they are running unix, you can try increasing this
  42. ; up to 1024 or even 2048.  If your host is running Waffle under DOS,
  43. ; drop this number down to 100.  If you want to specify that only one
  44. ; person per message should be used, try "1".
  45.  
  46. MAXRMAIL 256
  47.  
  48. ; The ML-COPY command tells GIGO to send back a copy of the mailing list
  49. ; message to the person who posts (if they are subscribed to the mailing 
  50. ; list).  By default, users who post are not sent back a copy
  51. ; of their message, since they've already seen the message.  ;-).
  52. ;
  53. ;ML-COPY
  54.  
  55.  
  56. ; The ML-HEADERS command tells GIGO to import as many headers 
  57. ; as reasonably possible into the mailing lists.  This will bloat
  58. ; the header sizes, but will allow for mime posts to the mailing 
  59. ; lists.
  60.  
  61. ML-HEADERS
  62.  
  63. ; The ML-RECEIVED-HEADERS
  64. ; Some people may want to import Received: lines, to show the message
  65. ; paths before the messages reach your machine.  Personally, I don't
  66. ; want'em.. 
  67.  
  68. ;ML-RECEIVED-HEADERS
  69.  
  70. ; ML-NEWSGROUPS tells GIGO that you want to keep the Newsgroups:
  71. ; kludge line, for cases where a mailing list is crossposted with
  72. ; a newsgroup.
  73. ; ML-NEWSGROUPS
  74.  
  75. ;
  76. ; The two commands are seperated, so that I (or someone else) can easily
  77. ; add in the ability to create Digest Messages (where one email message
  78. ; contains several mailing list messages), and also so that anyone who
  79. ; wishes to archive the messages into a text file may do so.
  80. ;
  81. ;CAPTURE dirname\ inputaddress owner  newsgroup       ECHONAME  badmail.ml Description
  82. ;EXPLODE dirname\ listfile.ml  owner  postnewsaddress postechoaddress
  83. ;
  84. ;  PHASE 1 : CAPTURING MESSAGES FOR THE MAILING LIST
  85. ;
  86. ; CAPTURE dirname\ inputaddress owner  newsgroup       ECHONAME  Description
  87. ; CAPTUREPRIV listname.ml dirname\ inputaddress owner  newsgroup       ECHONAME  Description
  88. ;
  89. ; The CAPTURE statement is designed to capture the messages from various
  90. ; sources.
  91. ;    o listname.ml : (CAPTUREPRIV only)
  92. ;                    The message will only be CAPTURE'd if the sender
  93. ;             is on the mailing list.  Otherwise, the CAPTUREPRIV
  94. ;                    statement is ignored.  See samples.
  95. ;    o dirname\    : You _must_ dedicate a single directory
  96. ;                    to each mailing list that you wish to support.
  97. ;    o inputaddress: This is the address that people send messages
  98. ;                    to when they want their message sent to everyone else.
  99. ;    o owner       : The address where errors in mail delivery should
  100. ;                    go to, examples are listname-err or listname-owner.
  101. ;    o newsgroup   : The newsgroup to capture and deliver to for gating
  102. ;                    (if not porting to a newsgroup, use a single dash "-")
  103. ;    o ECHONAME    : The echoarea that you want to capture and deliver to
  104. ;                    for gating (if not porting to an echo, use a single dash)
  105. ;    o badmail.ml  : This is a text file describing which messages you
  106. ;                    do _not_ want redistributed.  This would include
  107. ;                    provisions for watching for messages from mailer
  108. ;                    daemons and other message notification messages.
  109. ;                    A sample will be included in the GIGO archive.
  110. ;    o Description : A small line of text, ie "Foobar-Baz Mailing List"
  111. ;
  112. ; When GIGO is running, if it gets any messages to the inputadddress,
  113. ; or in the newsgroup or echo specified, it will save that message in
  114. ; the dirname\ as a *.MLQ file (.Mailing List Queue).  The first line
  115. ; of that text file should be a Ctrl-A  immediately followed by
  116. ; the email address of the person submitting the message, or NEWS,
  117. ; or ECHO.  This information, if present, will help GIGO not send a
  118. ; duplicate message back out to the source where the message came from.
  119. ; It will strip most headers off, only keeping the pertinant ones.
  120. ; It will also contain an "Errors-To:" address, with the address
  121. ; of owner in it.
  122.  
  123. ;
  124. ;  PHASE 2 : EXPLODING MESSAGES FROM THE MAILING LIST TO THE RECIPIENTS
  125. ;
  126. ; EXPLODE dirname\ listfile.ml  owner postnewsaddress postechoaddress
  127. ;
  128. ; The EXPLODE statement is used to take the MLQ files, and to send it to
  129. ; a list of recipients.
  130. ;
  131. ;    o dirname\    : You _must_ dedicate a single directory
  132. ;                    to each mailing list that you wish to support.
  133. ;    o listfile.ml : This is an ascii list of recipients that wish
  134. ;                    to receive messages from this mailing list.
  135. ;                    This file should contain one address per line.
  136. ;                    You may either edit the file manually, or look into
  137. ;                    installing LISTSERV which can automate subscription
  138. ;                    requests for multiple mailing lists.
  139. ;    o owner         This is where errors should be sent to.
  140. ;                    Common:  listname-owner or listname-err
  141. ;    o postnewsaddress  This is where messages that need to be posted
  142. ;                    to a newsgroup need to be sent.   GIGO provides
  143. ;                    an email-to-news interface, which you will need
  144. ;                    to have setup for this purpose (should be done up above!)
  145. ;                    (If you do not wish to have messages posted to the
  146. ;                    newsgroup, specify a single dash "-").
  147. ;    o postechoaddress  This is where messages that need to be posted
  148. ;                    to a fidonet echo need to be sent.   GIGO provides
  149. ;                    an email-to-echomail interface, which you will need
  150. ;                    to have setup for this purpose.
  151. ;                    (If you do not wish to have messages posted to the
  152. ;                    echo, specify a single dash "-").
  153. ;
  154. ;
  155. ;  Whenever GIGO runs, if there are any EXPLODE statements in the config
  156. ;  file, GIGO will look at the specified files for *.MLQ files.  If
  157. ;  it finds any, it will process those files, and rename them to
  158. ;  *.MLS files (Mailing List Sent).  You may either do further processing
  159. ;  on them, or simply delete them - that is up to you.  The author
  160. ;  saves them in an archive for later use.
  161. ;
  162. ;  When GIGO finds a MLQ file to be sent out, it will take a look at the
  163. ;  first line of the file.  If it starts with Ctrl-A (""), it will
  164. ;  assume that that first line contains the phrase "NEWS", "ECHO",
  165. ;  or th